Summary

Splits agents/catalog-doc-check.agent.md into an agent (behavioral logic) + skill (domain knowledge) by adding a new skills/ folder.

Why

• The skill (skills/catalog-doc/SKILL.md) is reusable: a developer-facing agent in .github-private can reference the same catalog documentation rules without duplicating them
• The agent stays focused on what to do (procedure, activation, output, constraints), while the skill owns what the rules are
• The workflow now also explicitly imports shared/global-instructions.md, which was previously referenced as a markdown link (not included in the prompt)

Changes

Content split rationale

Moved to skill:

• Severity level definitions
• All per-section validation rules (README existence, About, Key Features, Use Cases, Prerequisites, Technical Reference, Visuals, Contact/Support)
• Content to Include and Avoid table
• Common Issues and Solutions table

Stays in agent:

• Activation Guard (runtime event filtering)
• Scope (how to discover CatalogInformation/README.md)
• Validation Procedure (the ordered steps)
• Role and Constraints (read-only, no direct edits)
• Output Format (issue/PR creation logic)

⚠️ Breaking change for existing consumers

The agent.md no longer contains inline validation rules. Any repo that has compiled a lock.yml using the old catalog-doc-check.md workflow and does a runtime-import of only agents/catalog-doc-check.agent.md will be missing the rules at runtime.

Required action for consumers: Re-install and recompile workflows/catalog-doc-check.md to pick up the new multi-import structure:

gh aw install SkylineCommunications/_ReusableAgenticWorkflows/workflows/catalog-doc-check.md
gh aw compile